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1 . Overview and Scope 

This service template is compliant with the UPnP Device Architecture version l .0. It defines a service type 
referred to herein as RenderingControl. /. 

1.1. Introduction 

Most rendering devices contain a number of dynamically configurable attributes that affect how the current 
content is rendered. For example, video rendering devices, such as TVs, allow user control of display 
characteristics such as brightness and contrast, whereas audio rendering devices allow control of audio 
characteristics such as volume, balance, equalizer settings, etc. The RenderingControl. / service is intended 
to provide Control Points with the ability to query and/or adjust any rendering attribute that the device 
supports. 

The RenderingControl. / service enables a Control Point to: 

• Discover the set of attributes supported by the device. 

• Retrieve the current setting of any supported attribute 

• Change the setting of (e.g. control ) any modifiable attribute 

• Restore the settings defined by a named Preset 
The RenderingControl / service DOES NOT: 

• Control the flow of the associated content (e.g. Play, Stop, Pause, Seek, etc.). 

• Provide a mechanism to enumerate locally stored content. 

• Provide a mechanism to select the content that is to be rendered. 

• Provide a mechanism to send content to another device (via the home network or direct 
connection). 



1.2. Multi-input Devices 

Some high-end AV device are capable of receiving multiple pieces of content at the same and combining 
that content together so that it can be rendered together using a single set of output hardware. For example, 
while displaying a TV program, high-end TVs can also display additional content (e.g. VCR content) in a 
PIP (Picture-In-Picture) window. Similarly, a Karaoke machine can mix together the background music 
with a singer's voice so that both sounds are played together on the same set of speakers. 

As with all devices, the Rendering Control Service allows a Control Point to adjust the output 
characteristics of the post-mixed content before it is actually rendered. However, in many cases, Control 
Points may need to control the output characteristics of the individual input content before it is mixed 
together with the other input content. In order to support this, the Rendering Control Service includes an 
InstancelD parameter with each action that allows the Control Point to identify which content the action is 
to be applied (e.g. the post-mixed content or one of the pre-mixed input content items). 

By convention, an InstancelD of 0 indicates that the invoked action should be applied to the post-mixed 
content. Similarly, each pre-mixed input content is assigned a unique InstancelD whose value is a non- 
zero, positive integer. Refer to Section 2.5 (Theory of Operation) for additional information. 
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2. Service Modeling Definitions 

2.1. Service Type 

The following service type identifies a service that is compliant with this template: 
urn:schemas-upnp-org:service:RenderingControl / 

The shorthand RenderingControl. / is used herein to refer to this service type. 

2.2. State Variables 



Table 1: State Variables 



Variable Name 


Req. or 
Opt. 1 


Data 
Type 


Allowed Value 2 


Default 
Value 2 


Eng. 
Units 
















R 


siring 


CSV ' (string; 


















Brightness 


O 




\fin II 

Max Vendor defined 

Step 1 






( 'ontrusj 


(J 




\ lit) II 

\ lax 1 endor defined 
SlejL I 






Sharpness 


o 




j (in 0 

Max Vendor defined 
S «-'P ' 






i 1 leot mm 


a 




Min 0 

Max Vendor defined 
Siep 1 






(IreenVideoCain 


(j 




\ lin 0 

\ la.x Vendor defined 
S,en 1 






BlueVideoCain 






Mm 0 

\ la.x 1 endor defined 
Step 1 






KedlideoBlackl.evel 


o 




Min 0 

\ lax Vendor defined 
Step 1 






i,reen\ideoBluekl.evel 


<j 




Mm 0 

.\ las Vendor defined 
Step 1 







' CSV stands for Comma-Separated Value list. The type between brackets denotes the UPnP data type used 
for the elements inside the list. CVS is defined more formally in the ContentDirectory service template. 



© 1999-2002 Contributing Members of the UPnP™ Forum. All rights Reserved. 



RenderingControl:! Service Template Version 1.01 



r 




ail 


\tm 0 

Max Vendor defined 






>lor'U mj 1 ratlin 


(J 




Win 0 

Wax Vendor defined 
Step 1 






llorizontalKevsione 


O 




Win Vendor defined 

(Musi he 0/ 

Wax 1 'endor defined 






1 erliealkevslone 


(J 




\ I'm 1 "endor defined 

(Must be 0) ' 

Max 1 endor defined 

Step 1 


















Mi 


o 


■ 








1 'alume ' 


Q 


ml 


A I 'm 0 

Max Vendor defined 
^£ — 






— — : — 3 

i o/unieDB 






A I'm Vendor defined 




1 256 dl> 




Max Vendor defined 




Loudness 


o 


boolean 




















1 AR(j TYI'E Channel 


R 




See Table 2-15 


\ . 1 




A IR(, /)/'/; Iristai, 


R 


ui4 




A . 1 




! \R(, 1)1' I: Preset \ utile 


R 


sirm- 




V.I 


\ A 


Son-standard stale 
variables implemented by 
an I PnP vendor go here. 


X 


TBI) 


WD 


WD 


WD 



R = Required, O = Optional, X = Non-standard. 



2 Values listed in this column are required. To specify standard optional values or to delegate assignment 
of values to the vendor, you must reference a specific instance of an appropriate table below. 



Table 2-1: allowedValueRange for Brightness 







Value 


Req. or Opt. 




0 


R 


maximum 




fined 


R 


step 


1 


R 



4 The Volume and VolumeDB state variables are defined as a pair. Therefore, each implementation of this 
service MUST either support both of them or support none of them. At all times, these two state variables 
must remain synchronized with each other (i.e. both of them must always represent the same volume 
setting). 
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Table 2-2: allowed ValueRange for Contrast 



Value 


Req. or Opt. 


minimum 




R 


maximum 


f 'endor denned 


R 


step 




R 



Table 2-3: allowedValueRange for Sharpness 



Value 


Req. or Opt. 


minimum 




R 




'•■ endor defined 


R 


step 


1 


R 



Table 2-4: allowedValueRange for RedVideoGain 







Value 


Req. or Opt. 


minimum 




R 


maximum 


! endor ck 


fined 


R 


step 


I 


R 



Table 2-5: allowedValueRange for GreenVideoGain 



Va 




Req. or Opt. 


minimum 




R 


maximum 


i endor defined 


R 


step 




R 



Table 2-6: allowedValueRange for BlueVideoGain 



Value 


Req. or Opt. 


minimum 




R 


maximum 


i endor denned 


H 


step 




R 



Table 2-7: allowedValueRange for RedVideoBlackLevel 





Value 


Req. or Opt. 


minimum 




R 


maximum 


1 en It >/• defined 




step 


1 


R 


Table 2-8: allowedValueRange for GreenVideoBlackLevel 




Value 


Req. or Opt. 


minimum 






maximum 


1 endor defined 
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I step 1 / 1 R | 



Table 2-9: allowedValueRange for BlueVideoBlackLevel 



Value 


Req. or Opt. 


minimum 




R 


maximum 


i 'endor ik fined 


R 


step 




R 



Table 2-10: allowedValueRange for ColorTemperature 



Value Req. or Opt. 



minimum 


0 


R 


maximum 




R 


step 


L 


R 


Table 2-11: allowedValueRange for HorizontalKevstone 


Value 


Req. or Opt. 


minimum 


1 'endor defined (Musi be 0) 


R 


maximum 


i 'endor defined 


R 


Step 




R 



Table 2-12: allowedValueRange for VerticalKeystone 





Value 


Req. or Opt. 


minimum 


I 'endor defined l \lusl he 0) 


R 


maximum 


Vendor defined 


R 


step 


I 


R 


Table 2-13: allowedValueRanqe for Volume 




Value 


Req. or Opt. 


minimum 


0 


R 


maximum 


i 'endor defined 


R 


Step 


I 


R 


Table 2-14: 


allowedValueRange for VolumeDB 




Value 


Req. or Opt. 


minimum 


I endor defined 


R 


maximum 


Vendor defined 


R 


step 


I endor defined 


0 



Table 2-15: allowedValueList for A ARG TYPE Channel 
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Value 


Req. or Opt. 3 


Master 


R 


1 1 


o 


— 

/</■ 


o 


( 'I- 


() 


III. 


(.) 


/ s 


(J 


RS 


() 


/./( 


(> 


HI ( 


() 


SV.) 


() 


SI 


u 


SR 


() 


1 


(J 


11 


<) 


1 emlor-ilefmed 


(J 


Table 2-16: allowedVaiueList for A ARG TYPE PresetName 




Value 




"FaclorvDefaults- 


R 


" Insia/lationDefuiill.s 


(J 


I endor defined 


o 



2.2.1. LastChanqe 

This variable is used exclusively for eventing purposes to allow clients to receive meaningful event 
notifications whenever the state of the device changes. The LastChange state variable identifies all of the 
state variables that have changed since the last time the LastChange state variable was evented. Refer to 
Section 2.3. 1 (Event Model) for additional information 

The format of this state variable conforms to the XML schema described in Section 5 ("LastChange" State 
Variable Schema). The following XML document illustrates a typical example of the schema: 

<Event xmlns="urn:schemas-upnp-org:metadata-l-0/AVT_RCS"> 
<lnstanceID val="0"> 

<Brightness val="36'7> 
<Contrast val="54'7> 

</InstancelD> 
<InstanceID val="l"> 

<Mute channeK'Master" val="0"/> 

< Volume channel="CF"val-" ; ="24"/> 

< Instance! D> 
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</Evenl> 

As illustrated above, the LastChange state variable contains a single root element whose body contains one 
or more InstancelD elements, each corresponding to a (virtual) instance of the Rendering Control Service, 
whose state has changed since the last time the LastChange state variable was evented. Each InstancelD 
element contains one or more state variable elements that identify all of the state variables within that 
instance that changed. Each state variable element contains the new (current ) value of that state variable. 

In the example above, the Brightness and Contrast setting of instance 0 has changed to 36 and 54, 
respecitively. Additionally, the Mute setting on the Master channel of instance 1 has been set to 0 (false) 
(i.e. muting has been turned off) and the Volume of the Center Front channel of instance 1 has been set to 
24. Note: That only the audio-related state variable include a 'channel' attribute, which identifies the audio 
channel that has experienced a change. 

When a given state variable (within the same instance) changes multiple times before the moderation 
period of the LastChange state variable expires, only one state variable element will appear within the 
InstancelD element. The previous state variable element must be removed and replaced with a new state 
variable element that reflects the most recent value of that state variable. 

State variable elements may appear in any order within a given InstancelD element. This implies that no 
meaning may be deduced from the order in which the state variables for a given instance are listed. 
Similarly, the order of InstancelD elements has no particular meaning and may appear in any order. 

For example, when the Brightness of instance 0 changes from 26 to 54 then to 48. and the Brightness of 
instance 1 changes from 54 to 35, then to 1 1, LastChange is set to the following: 

<Event xmlns="urn:schemas-upnp-org:metadata-l-0/AVT_RCS"> 

<lnstanceID val="0"><Brightness val="48"/x/InstancelD> 
<lnstanceID val="l"><Brightness val="l l"/></]nstancelD> 

</Event> 

The LastChange state variable is the only state variable that is evented using the standard UPnP event 
mechanism.. All other state varaibes are indirectly evented via the LastChange state variable event. Refer 
to Section 2.3.1 (Event Model) for additional details. 



2.2.2. PresetNameList 

This variable contains a comma-separated list (i.e. CSV 3 (string)) of valid preset names currently 
supported by this device. Its value changes if/when the device changes the set of presets that it supports. 
This may occur in conjunction with a vendor-defined action or some other non-U PnP event. This state 
variable will include any of the predefined presets that are supported by the device. 



2.2.3. Brightness 

This unsigned integer variable represents the current brightness setting of the associated display device. Its 
value ranges from a minimum of 0 to some device specific maximum. A numerical change of I 
corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the brightness of the display's output. 
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2.2.4. Contrast 

This unsigned integer variable represents the current contrast setting of the associated display device. Its 
value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 
corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the contrast of the display's output. 



2.2.5. Sharpness 

This unsigned integer variable represents the current sharpness setting of the associated display device. Its 
value ranges from a minimum of 0 to some device specific maximum. A numerical change of 1 
corresponds to the smallest incremental change that is supported by the device. 

Higher values accentuate fine detail. 



2.2.6. RedVideoGain 

This unsigned integer variable represents the current setting of the red "gain" control for the associated 
display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical 
change of 1 corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the intensity of red in the display's output. See Section 2.2.22 for additional 
information. 



2.2.7. Green VideoGain 

This unsigned integer variable represents the current setting of the green "gain" control for the associated 
display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical 
change of 1 corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the intensity of green in the display's output. See Section 2.2.22 for additional 
information. 



2.2.8. BlueVideoGain 

This unsigned integer variable represents the current setting of the blue "gain" control for the associated 
display device. Its value ranges from a minimum of 0 to some device specific maximum. A numerical 
change of 1 corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the intensity of blue in the display's output. See Section 2.2.22 for additional 
information. 



2.2.9. RedVideoBlackLevel 

This unsigned integer variable represents the current setting for the minimum output intensity of red for the 
associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A 
numerical change of 1 corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the minimum output intensity of red in the display's output. See Section 2.2.22 for 
additional information. 
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2.2.10. Green VideoBlackLevel 

This unsigned integer variable represents the current setting for the minimum output intensity of green for 
the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A 
numerical change of I corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the minimum output intensity of green in the display's output. See Section 2.2.22 
for additional information. 



2.2.11. BlueVideoBlackLevel 

This unsigned integer variable represents the current setting for the minimum output intensity of blue for 
the associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A 
numerical change of 1 corresponds to the smallest incremental change that is supported by the device. 

Higher values increase the minimum output intensity of blue in the display's output. See Section 2.2.22 for 
additional information. 



2.2.12. ColorTemperature 

This unsigned integer variable represents the current setting for the "color quality" of white for the 
associated display device. Its value ranges from a minimum of 0 to some device specific maximum. A 
numerical change of I corresponds to the smallest incremental change that is supported by the device 

Lower values produce "warmer" shades of white (e.g. biased towards yellow/orange) and higher values 
produce "cooler" shades of white (e.g. biased towards blue). 



2.2.13. HorizontalKeystone 

This signed integer variable represents the current level of compensation for horizontal distortion 
(described below) of the associated display device. Its value ranges from device-specific negative number 
to a device specific positive number. Zero does not need to be in the middle of this range, although it will 
be for most devices. A numerical change of I corresponds to the smallest incremental change that is 
supported by the device. 

Horizontal distortion can occur when the display device is horizontally misaligned from the center of the 
viewing screen. For example, when a video/still-image projection device is shifted to the left or right of the 
display screen, the image becomes distorted (one side is taller than the other). The Horizontal Keystone 
state variable is used to compensate for this type of distortion. 

Note: The following descriptions illustrate the effect of the HorizontalKeystone state variable when applied 
to a projection device that is properly centered with respect to the viewing screen (e.g. no misalignment 
distortion exists). 

The left side of the display's output decreases in size as the value becomes more negative (i.e. moves 
farther away from zero). This produces a trapezoidal-shape image with the left and right edges remaining 
parallel, but with the left side shorter than the right side. 

The right side of the display's output decreases in size as the value increases (i.e. moves farther from zero 
in a positive direction). This produces a trapezoidal-shape image with the left and right edge remaining 
parallel, but with the right side shorter than the left side. 



Negative values 



Zero 



Positive values 
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2.2.14. VerticalKeystone 

This signed integer variable represents the current level of compensation for vertical distortion (described 
below) of the associated display device. Its value ranges from device-specific negative number to a device 
specific positive number. Zero does not need to be in the middle of this range, although it will be for most 
devices. A numerical change of l corresponds to the smallest incremental change that is supported by the 
device. 

Vertical distortion can occur when the display device is vertical misaligned from the center of the viewing 
screen. For example, when a video/still-image projection device is moved above or below the display 
screen, the image becomes distorted (i.e. the top and bottom edges have different lengths). The Vertical 
Keystone state variable is used to compensate for this type of distortion. 

Note: The following descriptions illustrate the effect of the VerticalKeystone state variable when applied to 
a projection device that is properly centered with respect to the viewing screen (e.g. no misalignment 
distortion exists). 

The bottom edge of the display's output decreases in size as the value becomes more negative (i.e. moves 
farther away from zero). This produces a trapezoidal-shape image with the top and bottom edges 
remaining parallel, but with the bottom edge shorter than the top edge. 

The top edge of the display's output decreases in size as the value increases (i.e. moves farther from zero in 
a positive direction). This produces a trapezoidal-shape image with the top and bottom edges remaining 
parallel, but with the top edge shorter than the bottom edge. 

Negative values Zero Positive values 

□ - □ 



2.2.15. Mute 

This boolean variable represents the current "mute" setting of the associated audio channel. A value of 
TRUE (e.g. a numerical value of l) indicates that the output of the associated audio channel is currently 
muted (i.e. that channel is not producing any sound). 



2.2.16. Volume 

This unsigned integer variable represents the current volume setting of the associated audio channel. Its 
value ranges from a minimum of 0 to some device specific maximum. A numerical change of l 
corresponds to the smallest incremental change that is supported by the device 

Lower values produce a quieter sound and higher values produce a louder sound. A value of 0 represents 
complete silence (on the associated channel) and a value of I represents the quietest level of sound 
supported by the device for that channel. 
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2.2.17. VolumeDB 

This signed integer variable represents the current volume setting of the associated audio channel. Its value 
represents the current setting in units of "1/256 of a decibel (dB)". This means that a numeric change of l 
corresponds to a volume change of 1/256 dB. The value range for this variable is a minimum value of - 
32,767 (8001 is) (which equals-l 27.996 ldB) and a maximum value of 4-32,767 (7FFFi&) (which equals 
+ 127.9961dB). The value corresponding to 8000k. is invalid. 

Each implementation of this service must specify a vendor-defined minimum and maximum value. Most 
implementations will not support all incremental values between the supported minimum and maximum 
values. If a Control Point attempts to set VolumeDB to an unsupported value (within the specified 
minimum and maximum values), the device will set the volume to the closest setting that is supported by 
the device for the associated channel. 

Lower values (including negative values) produce a quieter sound and larger values produce a louder 
sound. Setting the volume to the minimum value supported by the device produces complete silence on 
that channel. 



2.2.18. Loudness 

This boolean variable represents the current "loudness" setting of the associated audio channel. A value of 
TRUE (e.g. a numerical value of l ) indicates that the loudness effect is active. 



2.2.19. A ARG TYPE Channel 

This variable is used to identify a particular channel of an audio output stream. A channel, except the 
Master channel, is associated with the location of the speaker where the audio data stream is to be 
presented. It is customary to refer a channel using the spatial position of associated speaker as described 
below. 

The Master channel is a logical channel and, therefore, has no spatial position associated with it. A one- 
channel channel cluster does not have spatial position associated with it either and will use the Master 
channel to control its properties. 

The following channel spatial positions are defined: 

Master (Master) 
Left Front (LF) 
Right Front (RF) 
Center Front (CF) 

Low Frequency Enhancement (LFE) [Super woofer] 
Left Surround (LS) 
Right Surround (RS) 
Left of Center (LFC) [in front] 
Right of Center (RFC) [in front] 
Surround (SD) [rear] 
Side Left (SL) [left wall] 
Side Right (SR) [right wall] 
Top (T) [overhead] 
Bottom (B) [bottom] 

A channel cluster is the collection of all channels, including the Master channel, within an audio stream. A 
single channel (mono) cluster has only one channel - the Master channel. A two-channel (stereo) cluster 
has three channels -- the Master channel, the Left Front channel, and the Right Front channel. In this 
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specification, only the Master channel is required. AH other channels are optional, see Table 2- 1 5 for 
details. 

2.2.20. A ARG TYPE InstancelD 

This signed integer parameter is used to specify the logical instance of the Rendering Control Service to 
which the associated action should be applied. A value of '0' indicates that the action should be applied to 
the global (post-mix) stream, as shown in Figure 1 

2.2.21. A ARG TYPE PresetName 

This string parameter is used to specify the name of a device preset. This may include any of the names 
listed in the PresefNameList state variable or any of the predefined presets (listed below) that are supported 
by the device. 



Table 2-17: Predefined names of some common presets 



Value 


Definition 


Factory Defaults 


The factory settings defined 
by the device's manufacturer. 


InstallationDefaults 


The installation settings 
defined by the installer of the 
device. This may or may not 
be the same as the Factory 
defaults. 



2.2.22. Relationships Between State Variables 

Except for the LastChange and two volume-related state variables (e.g. Volume and VolumeDB), all state 
variables operate independently. However, whenever any (non A ARGTYPExxx) state variable 
changes, a state change descriptor is added to the LastChange state variable to reflect the modified state. 
Refer to the description of the LastChange state variable and overall eventing model for more details. 

xxxVideoGain and xxxVideoBlackLevel: 

As described in Section 2.2.6 - 2.2.1 1 {Rcil! /<W< nun thru niue} nlcglikickl cvc!), a pair of state variables 
is defined to control the output intensity of each primary color (i.e. red, green, and blue). The state variable 
pair associated with each color includes one state variable to control the "gain" of that color and one state 
variable to control the minimum output intensity of that color (e.g. I\ ,/l , ; , >■ and 

RecllhJeoBlacklere/ ). 

Although these two state variables are associated with the same color, they function independently from 
each other (e.g. changing the value of one state variable does not affect the value of the other). However, 
each state variable within a given pair (i.e. associated with a given color) may affect the output intensity of 
that color. For example, while displaying a static image, increasing the value of either the Reil\"hL-i>< hiin 
or AW ) 'ith'oliluckLewl state variables may cause an increase the amount of red that is displayed. 
Similarly, decreasing either state variable may cause a decrease in the amount of red. 

The precise effect of these two variables may vary from device to device. However, as a common example, 
implementation the A\ . ' ' controls the multiplication factor between the input and output intensity 
of the color red, and the AW I iilcoHlackl .ewl controls minimum output intensity of red regardless of the 
input intensity. Thus, a typical implementation may be described using a variation of the following 
formula: 

Red Output Intensity - AW I i,k , >j ur, * Red Input Intensity + AWI i(k<t >BluckI.evel 



© 1999-2002 Contributing Members of the UPnP™ Forum. All rights Reserved. 



RenderingControl:! Service Template Version 1.01 



18 



Volume and VolumeDB 

The Volume and VolumeDB state variables are directly related to one another. Both state variables reflect 
the current volume setting, but each one does so using a different numeric scale. The Volume state variable 
uses a linear numeric scale in which each discreet volume setting that is supported by the device is 
represented by a contiguous range of values from 0 to some maximum value. This maximum value 
indicates the total number of discrete settings that the device supports. In contrast, the VolumeDB state 
variable uses a linear numeric scale based on l/256dB engineering units. This provides a mechanism to 
achieve a uniform volume setting regardless between different devices. Note: The same VolumeDB setting 
on two different devices will not necessarily produce the same loudness of sound. 



2.3. Eventing and Moderation 

As the table below summarizes, the RenderingControl 7 specification uses moderated eventing for only one 
of its standard state variables and no eventing for the rest. 



Table 2: Event moderation 



Variable Name 


Evented 


Moderated 
Event 


Max Event 
Rate 1 


Logical 
Combination 


Min Delta 
per Event 2 


LastChamie 


Yes 


Yes 


(12 






























Briah/ness 
























Sharpness 


Xo 










It u(. iain 


No 










CreenlldeoCain 


Xo 










1 1 ideodain 












RedVideoBlackl.evel 


Xl> 










GreenVideoBlackl.evel 












BlnelideoBlaekLevel 












Color lemperatwv 












Horizontal 'Keystone 












1 crncalKeysionu 
























Mute 














Xo 










1 olumeDB 












Loudness 
























A ARC, TYI'E Channel 












A ARC, TYPE InsianeelD 












1 IRC DPI: PresetXume 


.Xo 
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\on-sU„nhirJ Mole v,//7,/A/o- 


TBI) 


TBI) 


TBI) 


TBI) 


TBI) 


implemented h) an ! I'nl' 












vendor go here 













' Determined by N, where Rate = (Event )/(N sees). 
2 (N) * (ailowedValueRange Step). 



2.3.1. Event Model 

Since the Rendering Control Service supports multiple logical instances (via the InstancelD parameter 
included in each action), the traditional UPnP eventing model is unable to differentiate between multiple 
instances of the same state variable. Therefore, the Rendering Control Service event model defines a 
specialized state variable (LastChange) that is used exclusively for eventing individual state changes. In 
this model,the LastChange state change is the only variable that is evented using the standard UPnP event 
mechanism. All other state variables are indirectly evented via the LastChange state variable. (Note: 
A_ARG_TYPE_ state variables are not evented, either directly or indirectly.) 

When the value of a state variable changes, information about that change is added to the LastChange state 
variable as described in Section 2.2.1 ( l.usiChanse ). As a result of modifying the LastChange state 
variable, its new value (i.e. the information describing the original state change) is evented using the 
standard UPnP eventing mechanism. In this manner, the change to the original state variable is indirectly 
evented to all interested Control Points. 

Since the LastChange state variable is a moderated state variable, multiple state changes are accumulated in 
the LastChange state variable until its moderation period expires. When this occurs, the current value of 
the LastChange state variable is sent out using the standard UPnP eventing mechanism. This notification 
informs interested Control Points of all state changes that have occurred since the previous LastChange 
event was sent. 

After the LastChange state variable is evented, its contents are cleared out in preparation for the next state 
change. (Note: The act of clearing out the "stale" contents of the LastChange state variable does not need 
to generate another event notification even though its value has changed. Doing so would only generate 
unnecessary network traffic). Because the LastChange state variable is moderated, a given state variable 
may change multiple times before the current moderation period expires. In such cases, the LastChange 
state variable will contain a single entry for that state variable reflecting its current (most recent) value. 

The standard UPnP event mechanism indicates that when a Control Point subscribes to receive events, the 
current values of all evented state variables are returned to the subscriber. However, since the LastChange 
state variable is the only state variable that is directly evented (i.e. all other state variables are indirectly 
evented via the LastChange state variable), it isn't very meaningful to respond to an event subscription 
request with the current value of the LastChange state variable. Its value is too transitory to be of any use 
to the subscribing Control Point. Therefore, when an event subscription is received, the device should 
respond with the current values of all (indirectly evented) state variables within all valid instances of this 
service. Refer to Section 2.2.1 ( Las/Change ) for additional information. 



2.4. Actions 

The following tables and subsections define the various RenderingControl. / actions. Except where noted, 
if an invoked action returns an error, the state of the device will be unaffected. 

Table 3: Actions 
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Sckcll're.wl 








GeiBriahmess 


U 




U 


GetComras 


(J 


SelConirast 


O 


GelSharpness 


(J 


i l, ii 7 /, , v 


u_ 


' l ikeik n/eui nun 


(J 


V II l u 1 , H u'O 


a 


GeiGreenl ideoGain 


o 


SelGreenl ide, 


a 


Gel Blue! 'ideoGain 


G 


Set Blue 1 ideo(.,um 


O 


< /■ ideoBhukl evel 


O 


• 


(J 


< ,cf< ,i eenl 'uk.oBlackl.evet 


(_> 


V. /( c-//l UcaJihu hi , 1', / 


(J 


GetBlueVkkoBlackl.evel 


a 


SeiBliielideoBlackkevet 


o 


GetColorlemoeralwe 


(j 


Si, , 


a 


i *e, 1 /.'." i:.'i:i.i!i.e\ o,"K 


0 


SelHorizonlalkevslone 


(2 


i ick erncalkevxione 


0 


Sell crlicalki. \ Urih 


a 






Gel Mute 


<> 


Set Mute 


a 


Geil'olume 


ij 


Sell olume 


Ll 


• <i7< ■'htiih'DB 


a 


.Sell ofinnei'B 




Cell olumeDBRanoe 


a 


< , /, . :// ///. 


(2 


Setl.oudness 


o 


Nonstandard actions implemented by on I 1'nP vendor go here. 


X 



R = Required, O = Optional, X = Non-standard. 
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2.4.1. ListPresets 

This action returns a list of the currently defined presets. The CurrentPresetNameList "out" parameter 
contains a comma-separated list (i.e. CSV 6 (string)) of preset names that include both predefined (static) 
presets and user-defined (dynamically created) presets that may be created via a private vendor-defined 
action. 

2.4.1. 1. Arguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IX 


.1 U<(, D PI: Insianc 






c'//> 




(H 1 


/'/v.m-/\./<;; 1 -//W 









2.4.1.2. Effect on State 

This action does not affect the state of the service. 



2.4.1.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


70"! 


Invalid instancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by I PnP vendor.) 



2.4.2. SelectPreset 

This action restores (a subset ) of the state variables to the values associated with the specified preset. The 
specified preset name may be one of the predefined presets (listed in Table 2-17) or one of the user-defined 
presets that may have been created via a private vendor-defined action. The selected preset determines 
which state variables will be affected. 

2.4.2.1. Arguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IX 


/ \d> , i ) • mm, 






12 




!X 


A ARC, TYPE PreselXu 









2.4.2.2. Effect on State 

This action sets the state of the service to the values associated with the specified preset. 



6 CSV stands for Comma-Separated Value list. The type between brackets denotes the UPnP data type used 
for the elements inside the list. CVS is defined more formally in the ContentDirectory service template. 
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2.4.2.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


701 


Invalid Name 


The specified name is not a valid preset name. 


702 


Invalid InstanccID 


The specified instancelD is invalid. 


800-899 


TBD 


iSpecilied b) I. f'nl' vendor.) 



2.4.3. GetBriqhtness 

This action retrieves the current value of the Brightness state variable of the specified instance of this 
service. 

2.4.3. 1. Arguments 





Direction 


relatedStateVariable 


InstancelD 
Current flriahmes.s 


PIT 


,1 ARC, TYPE Insianc 
dl! 

Brightness 



2.4.3.2. Effect on State 

This action does not affect the state of the service. 



2.4.3.3. Errors 





mmm 


(» ^iSnmTff«f.# ljt '^nr'^C^rVSf!^'^^^^ -fe^i '-T 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified h\ 1 fnf vendor i 



2.4.4. SetBriqhtness 

This action sets the Brightness state variable of the specified instance of this service to the specified value. 



2.4.4.1. Arguments 



Argt 


ment(s) 


Direction 


relatedStateVariable 


Insta 


ice ID 


IN 


A ARG TYPE Instan 








celD 


Desii 


edBriehlness 


IN 


Brightness 



2.4.4.2. Effect on State 

This action affects the Brightness state variable of the specified instance of this service. 



2.4.4.3. Errors 



erro 


rCode 


errorDescriptior 


Descripti 


>n 


402 jlnvalid Args | See UPnP Device Architecture section on Control. 
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50 


Action Failed 


See UPnP Device Architecture 




n Control. 


702 


Invalid InstancelD 


The specified instance! D is in\ 


alid. 




800-899 


TBD 


(Specified b\ ( 'PnP vendor ) 



2.4.5. GetContrast 

This action retrieves the current value of the Contrast state variable of the specified instance of this service. 



2.4.5.1. Arguments 



Argument(s) 


Direction 


reiatedStateVariable 


InstancelD 


LI 


A ARC, TYPE Insianc 






elD 




OUT 


Contrast 









2.4.5.2. Effect on State 

This action does not affect the state of the service. 



2.4.5.3. Errors 



errorCode errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TB 


(Specified by ! 1'nl' vendor.) 



2.4.6. SetContrast 

This action sets the Contrast state variable of the specified instance of this service to the specified value. 



2.4.6. 1. Arguments 



InstancelD 




a— m 

1 IRC DPI: Insianc 
ell) 


Desiredi ontrasi 


IE 


Contrast 



2.4.6.2. Effect on State 

This action affects the Contrast state variable of the specified instance of this service. 

2.4.6.3. Errors 



402 


Invalid Args 


See UPnP D 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by I PnP vendor./ 
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2.4.7. GetSharpness 

This action retrieves the current value of the Sharpness state variable of the specified instance of this 
service. 



2.4. 7. 1. Arguments 





ment(s) 


Direction 


relatedStateVariable 


InslancelD 




1 ARC, TYI'l. Insianc 

dll 




(jrr 





2.4.7.2. Effect on State 

This action does not affect the state of the service. 



2.4.7.3. Errors 



errorCode 


errorDescript 


B 


Descriptio 




402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


800-899 


FBI) 


(Specified by I'PnP vendor.) 



2.4.8. SetSharpness 

This action sets the Sharpness state variable of the specified instance of this service to the specified value. 



2.4.8.1. Arguments 





Direction 


relatedStateVariable 


InslancelD 


IX 


1 ARC, TYPE Insianc 






ell> 


1 icyircJSharpness 


A 











2.4.8.2. Effect on State 

This action affects the Sharpness state variable of the specified instance of this service. 

2.4.8.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


70: 


Invalid InstancelD 


The specified instance! D is invalid. 


800-899 


TBI) 


(Specified by t I'nP vendor.) 



2.4.9. GetRedVideoGain 

This action retrieves the current value of the RedVideoGain state variable of the specified instance of this 
service. 
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2.4. 9. 1. Arguments 



Argu ment(s) 


Direction 


relatedStateVariable 


InsiancelD 


IX 


A ARC IIP!-: Insianc 






elD 


( urrentRec 


(JUL 


Lo(,ain 



2.4.9.2. Effect on State 

This action does not affect the state of the service. 



2.4.9.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP De\'ice Architecture section on Control, 


501 


Action ¥ ailed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TRD 


(Specified by UPnP vendor.) 



2.4.10. SetRedVideoGain 

This action sets the RedVideoGain state variable of the specified instance of this service to the specified 
value. 



2.4. 10. 1. Arguments 





Direction 


relatedStateVariable 


InsiancelD 


AV 


,1 ARC, TYPE Insianc 






ell) 


DesiredRedl'ideoCain 


ZA 


'c«x, am 



2.4. 10. 2. Effect on Stale 

This action affects the RedVideoGain state variable of the specified instance of this service. 



2.4. 10.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by P/'nP vendor i 



2.4.11. GetGreen VideoGain 

This action retrieves the current value of the GreenVideoGain state variable of the specified instance of this 
service. 
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2.4. I 1. LA rguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


LX 


,1 ARC, TYPE Insianc 






elD 


( itrrenlGreenl ukoCain 


OCT 


< i <n deouam 



2.4.1 1.2. Effect on Stale 

This action does not affect the state of the service. 



2.4.1 U.Errors 





402 


Invalid Args 


See UPnP Device Architecture section on Controi. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by I'I'nP vendor.) 



2.4.12. SetGreenVideoGain 

This action sets the GreenVideoGain state variable of the specified instance of this service to the specified 
value. 

2.4. 12. 1. Arguments 





Direction 


relatedStateVariable 


Instance ID 


IX 


,1 ARC TYPE lnstanc 
ell) 


/ k/eoGain 


IX 


i.reenl nkoGnw 



2.4. 12.2. Effect on State 

This action affects the GreenVideoGain state variable of the specified instance of this service. 

2.4.12.3. Errors 



errorCode 


errorDescription 


Description ' 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by 1 PnP vendor ) 



2.4.13. GetBlue VideoGain 

This action retrieves the current value of the BlueVideoGain state variable of the specified instance of this 
service. 
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2.4. 13. 1. Arguments 





t(s) 


Directior 


relatedStateVariable 


Instance ID 


A 


1 ARC T)'Pi: Insianc 
ell) 




Oil 


• /,/ . « ><,ain 



2.4. 13. 2. Effect on State 

This action does not affect the state of the service. 



2.4.1 3.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TB 


(Specified by I PnP vendor.) 



2.4.14. SetBlueVideoGain 

This action sets the BlueVideoGain state variable of the specified instance of this service to the specified 
value. 



2.4. 14. 1. Arguments 



Argi 


ment(s) 


Direction 


relatedStateVariable 




ice ID 


IX 


1 \H(, D PI: Insianc 






dJJ 






A 


lilliel ideal, ain 



2.4. 14.2.Effect on State 

This action affects the BlueVideoGain state variable of the specified instance of this service. 



2.4. 14.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TB 


(Specified by CP nl' vendor./ 



2.4.15. GetRedVideoBlackLevel 

This action retrieves the current value of the RedVideoBlackLevel state variable of the specified instance of 
this service. 
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2.4. 15. LA rguments 



Argument(s) 


Directio 




relatedStateVariable 


InstancelD 


IX 


A ARC! TYPE Insianc 
ell) 


CurreniRedl ideoBlackl.evel 


Oil 


Red\'ideoBlackl.evel 



2. 4. 1 5. 2. Effect on State 

This action does not affect the state of the service. 



2.4.1 SJ.Errors 



ErrorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


50] 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by (T'ni' vendor.) 



2.4.16. SetRedVideoBlackLevel 

This action sets the RedVideoBlackLevel state variable of the specified instance of this service to the 
specified value. 



2.4. 16. 1. A rguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


LX 


A ARC, TYRE Insianc 






ell) 


1 k'MiVi/Redl ideoBlackl-evel 


IX 


Redl'ideoBluikLevel 



2.4. 16.2.Effect on State 

This action affects the RedVideoBlackLevel state variable of the specified instance of this service. 



2.4. 16.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by I I'nl' vendor ) 



2.4.17. GetGreen VideoBlackLevel 

This action retrieves the current value of the GreenVideoBlackLevel state variable of the specified instance 
of this service. 
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2. 4. 1 7. LA rgu merits 



k ^^^^ ^Ijjj^r^^rjTir*^^ 


Direction 


relatedStateVariable 


InsiuncelD ~~ 


m 


A ARC, TYPE /nsianc 






ejj) 


C,irreni(,re.en\ideoBlackl.evel 


Oil 


(ireenl ideo/ilackl.evel 









2.4. 1 7. 2. Effect on State 

This action does not affect the state of the service. 



2.4.1 7.3.Erwrs 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


70:' 


Invalid InstancelD 


The specified instance] D is invalid. 


800-899 


TBI) 


(Specified by Cl'nl' vendor.; 



2-4.18. SetGreenVideoBlackLevel 

This action sets the GreenVideoBlackLevel state variable of the specified instance of this service to the 
specified value. 



2.4. 18. 1. Arguments 



Argument(s) 




Direction 


relatedStateVariable 


/nshincelD 




11 


A ARC Dl'l: Imlunc 








ell) 




eoBlackLerel 


A 


lh-een\uh'olihickl.ewl 



2.4. 18.2. Effect on State 

This action affects the GreenVideoBlackLevel state variable. 



2.4.18.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


'/<' 


(Specified by Id'nP vendor.} 



2.4.19. GetBlueVideoBlackLevel 

This action retrieves the current value of the BlueVideoBlackLevel state variable of the specified instance 
of this service. 
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2. 4. 1 9. LA rguments 


Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IX 


i ARC, TYPE Instanc 






elD 


CwrenlBluetideoBhickl.evel 


at 7 


Bluet ideoBlackl.evel 



2. 4. 1 9. 2. Effect on State 

This action does not affect the state of the service. 



2.4. 19.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action T ailed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by I T'nl' vendor.) 



2-4.20. SetBlue VideoBlackLevel 

This action sets the BlueVideoBlackLevel state variable of the specified instance of this service to the 
specified value. 



2. 4.20. 1. Arguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


AY 








dlj 


> ui /'Hint i toBlackl.eve, 




BluefideoBlackl.evel 



2.4. 20. 2. Effect on State 

This action affects the BlueVideoBlackLevel state variable of the specified instance of this service. 



2.4.20.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by I'd'nl' vendor.) 



2.4.21. GetColorTemperature 

This action retrieves the current value of the ColorTemperature state variable of the specified instance of 
this service. 
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2.4.21. 1. Arguments 


Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IS 


,( ARC, Instanc 






ell) 


< itrrcntf 'olor 1 emperature 


(H T 


( oh a 1 1 in} 1 1 iiim 



2.4.2 l,2.Effect on State 

This action does not affect the state of the service. 



2.4.2 1.3. Errors 



errorCode 


errorDescription 


Description 


40? 


Invalid Args 


See UPnP Device Architecture section on Control. 


50 1 


Action Failed 


See UPnP Device Architecture section on Control. 


70:: 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by I I'nl' vendor ) 



2.4.22. SetColorTemperature 

This action sets the ColorTemperature state variable of the specified instance of this service to the specified 
value. 



2. 4. 22. 1. Arguments 



^2 " i ^-'t^'.-l-^J.^t^u' 


Direction 


relatedStateVariable 


Instance! D 


is 


A ARC TYI'i: Insianc 






ell) 


Desireck ' uloriemperalure 


IX 


( inil. /;// enititre 









2.4.22.2. Effect on State 

This action affects the ColorTemperature state variable of the specified instance of this service. 



2.4. 2 2. 3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by CPnP vendor ) 



2.4.23. GetHorizontalKevstone 

This action retrieves the current value of the HorizontalKeystone state variable of the specified instance of 
this service. 
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2. 4. 23. LA rguments 





t(s) 


Directi 


m 


relatedStateVariable 


Instance 11) 


IX 


1 ARC TYPE Instanc 
till 


CmrentUonzonialkevsione 


01 T 


Horizontal Keystone 



2.4.23. 2.Effect on State 

This action does not affect the state of the service. 



2.4.23.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Dev ice Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


WD 


(Specified by I PnP vendor A 



2.4.24. SetHorizontalKeystone 

This action sets the HorizontalKeystone state variable of the specified instance of this service to the 
specified value. 



2.4.24. 1. Arguments 





Direction 


relatedStateVariable 


hvittineelD 


IX 


1 ARC, DPI: Insnmc 






ell) 


DesiredllorizonhilKevslone 


IX 


Horizontal keystone 



2.4.24.2. Effect on State 

This action affects the HorizontalKeystone state variable of the specified instance of this service. 



2.4.24.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by UPnP vendor ) 



2.4.25. GetVerticalKeystone 

This action retrieves the current value of the VerticalKeystone state variable of the specified instance of 
this service. 
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2. 4. 25. 1. Arguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IX 


A ARC TYPE Inst one 






ell) 


Cumuli enicalKexslone 


OUT 


l 'erticalKevsione 



2.4.2 5. 2. Effect on State 

This action does not affect the state of the service. 



2.4.25.3.Errors 



errorCode 


errorDescription 


Description 


402 


invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified h) ' "nP vendor.) 



2.4.26. SetVerticalKeystone 

This action sets the VerticalKeystone state variable of the specified instance of this service to the specified 
value. 



2.4.26. 1. Arguments 





Direction 


relatedStateVariable 


InstancelD 


IX 


A A R(i TYPE Instanc 






ell) 


ke) si one 


IN 


1 'erticalKevsione 



2.4. 2 6. 2. Effect on State 

This action affects the VerticalKeystone state variable of the specified instance of this service. 



2.4.26.3. Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by UPnP vendor.) 



2.4.27. GetMute 

This action retrieves the current value of the Mute setting of the channel for the specified instance of this 
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2. 4. 2 7. LA rgu merits 





Direction 


relatedStateVariable 


InstancelD 


IS 


A ARC DPI, Insumc 






elD 


Channel 


IX 


A ARC, TV PP. Channe 






1 


< m rem Male 


(ILL 





2. 4. 27. 2. Effect on State 

This action does not affect the state of the service. 



2.4,27 J.Errors 





402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


/Specified by UPnl' vendor.) 



2.4.28. SetMute 

This action sets the Mute state variable of the specified instance of this service to the specified value. 



2. 4. 28. LA rgu merits 



Argument(s) 


Direction 


relatedStateVariable 


Instance IP " 


L\ 


1 A ARC DPI: Insianc 






ell) 


Channel 


[S 


1 ARC TYPE Channe 






I 


Desired Mine 


[S 


Mule 



2.4. 28. 2. Effect on State 

This action affects the Mute state variable of the specified instance of this service. 



2.4.28.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


Sec UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by liPnP vendor./ 
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2.4.29. GetVolume 

This action retrieves the current value of the Volume state variable of the specified channel for the 
specified instance of this service. The CurrentVolume (OUT) parameter contains a value ranging from 0 to 
a device-specific maximum. See Section 2.2.16 ( ) Plume ) for more details. 



2.4.29. 1. Arguments 



Argument(s) 


Direction 


related State Variable 


InsiuncelD 


IS 


1 ARC TYRE Inskmc 






elf) 


( 'hannel 


AY 


A ARC, TYRE ( lianne 
1 




01 T 





2.4.29.2. Effect on State 

This action does not affect the state of the service. 



2.4.29.3.Erwrs 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


70^ 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBI) 


(Specified by UPnP vendor.) 



2.4.30. SetVolume 

This action sets the Volume state variable of the specified Instance and Channel to the specified value. The 
DesiredVolume input parameter contains a value ranging from 0 to a device-specific maximum. See 
Section 2.2.16 (Volume) for more details, 



2. 4.30. LA rguments 



Argument(s) 


Direction 


relatedStateVariable 


Instance!!) 


A 


A ARC TYRE Inshmc 
ell) 




IS 


A ARC, TYRE Choline 
I 


Desired! olume 


ES 


1 'olume 



2.4.30.2.Effect on State 

This action affects the Volume and VolumeDB state variables of the specified instance and channel. Both 
state variables need to change consistently. 



2.4.30. 3. Errors 





402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


70:^ 


Invalid InstancelD 


The specified instancelD is invalid. 
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\ 800-899 I IBP) | (Specified by CPnP vendor J 



2.4.31. GetVolumeDB 

This action retrieves the current value of the VolumeDB state variable of the channel for the specified 
instance of this service. The CurrentVolume (OUT) parameter represents the current volume setting in 
units of 1/256 decibels (dB). See Section 2.2. 17 ( I olumeDB ) for more details, 



2.4. 3 1.1. A rguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IN 


,1 ARC, DPI. Insianv 






ell) 


Channel 


IN 


A ARC DPI: Choline 






/ 


( 'unenP'olunie 


OCT 


i olumeDB 









2.4.3 1 .2.Effect on State 

This action does not affect the state of the service. 



2.4.3 1.3.Errors 



errorCode 


errorDescriptio 


1 Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by CPnP vendor) 



2.4.32. SetVolumeDB 

This action sets the VolumeDB state variable of the specified Instance and Channel to the specified value. 
The DesiredVolume parameter represents the desired volume setting in unit of 1/256 decibels (dB). See 
Section 2.2. 1 7 ( I olumeDB ) for more details. 



2. 4. 32. l.A rguments 



Argument(s) 


Direction 


relatedStateVariable 


InstancelD 


IN. 


A IR(, DPI Imlaih 






ell) 


Channel 


IN 


A ARC DPR. Channe 






I 


iiredl olume 


IN. 


I 'olumeDB 



2.4.32.2.Effect on State 

This action affects the Volume and VolumeDB state variables of the specified instance and channel. Both 
state variables need to change consistently. 
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2.4. 3 2. 3. Errors 



402 


Invalid Args 


See UPnP Device rch tion on 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by UPnP vendor.) 



2.4.33. GetVolumeDBRanae 

This action retrieves the valid range for the VolumeDB state variable of the channel for the specified 
instance of this service. The MinValue and MaxValue (OUT) parameter identify the range of valid values 
for the VolumeDB state variable in units of 1/256 decibels (dB). See Section 2.2.17 ( l oli/me ld-l) for more 
details. 



2.4.33. 1. Arguments 





Direction 


relatedStateVariable 


InsiancelD 


ZA 


A \R(i DTi: Insionc 




1222 


Channel 


A 


\ \R(, DPI. ( Iniivie 




1 


MM'alue 


Oil 


lolnmeim 


Ma.xl'alue 


(JIJ 


lolumePB 



2.4.33.2. Effect on State 

This action does not affect the state of the service. 



2.4.33.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


1 he specified instancelD is invalid. 


800-899 


IB 


(Specified by UPnP vendor.) 



2.4.34. GetLoudness 

This action retrieves the current value of the Loudness setting of the channel for the specified instance of 
this service. 



2.4.34. 1. Arguments 



Argu ment(s) 


Direction 


relatedStateVariable 


InstancelD 


A 


/ AR(i DPI. Insianc 






ell) 


( 'hatmel 


IX 


A ARC, TYPE Choline 




I 
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| ( unvm Loudness \ QL1 \ LdUiimddt | 

2.4.34.2.Effect on State 

This action does not affect the state of the service. 



2.4.34.3.Errors 





402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architectui e sectic i mi ( ontrol 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified h\ ! I'll!' vendor.) 



2.4.35. SetLoudness 

This action sets the specified value of the Loudness state variable of the channel for the specified instance 
of this service to the specified value. 



2.4.35. l.Arguments 



Argument(s) 


Direction 


relatedStateVariable 


InslancelD 


A 


1 ARC Did: Inshinc 




did 


( hannel 


A 


A ARC 1 ) '/'A' (dm nne 






1 


hesircdLoadiicss 


_V 


: tmdness 



2.4.3 5.2.Effect on State 

This action affects the Loudness state variable of the specified instance of this service. 



2.4.35.3.Errors 



errorCode 


errorDescription 


Description 


402 


Invalid Args 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


702 


Invalid InstancelD 


The specified instancelD is invalid. 


800-899 


TBD 


(Specified by UPnP vendor.) 



2.4.36. Relationships Between Actions 

There is no inherent relationship between any of the various actions. All actions may be called in any 
order. 



2.4.37. Common Error Codes 

The following table lists error codes common to actions for this service type. If an action results in multiple 
errors, the most-specific error should be returned. 
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errorCode 


errorDescription 


Description 


401 


Invalid Action 


See UPnP Device Architecture section on Control. 


4o: 


Invalid Args 


See UPnP Device Architecture section on Control. 


40<! 


Invalid Var 


See UPnP Device Architecture section on Control. 


501 


Action Failed 


See UPnP Device Architecture section on Control. 


600-699 


TBD 


Common action errors. Defined by UPnP Forum Technical 
Committee. 


100-899 


TBD 


(Specified by I PnP vendor.) 



2.5. Theory of Operation 

2.5.1. Multi-input Devices 

lVlany traditional rendering devices are capable of receiving and rendering only a single item of content at a 
time. For example, traditional TVs can only receive and display a single TV show at a time, and a stereo 
system can only play a single song at a time. However, more and more devices are able to receive and 
render multiple items of content at the same time even though there is only a single piece of rendering 
hardware (e.g. a single TV screen or a single set of speakers). This capability is known as as "mixing". 

As an example, while watching TV, a small Picture-in-a-Picture (PIP) can be overlaid on top of the main 
TV show so that another TV show (or VCR tape) can be watched at the same time. Although the TV 
contains a single set of output hardware (e.g. a single screen), the TV can take multiple items of content, 
mix them together, and render them both on the one screen.. Similarly, a karaoke system takes a singer's 
voice, mixes it with some background music, and renders it on a single set of speakers. 

In the examples above, these 'multi-content' devices support a fixed number of input streams. However, 
there some devices that support an arbitrary number of input streams. For example, a PC can take some 
video content and 'mix' it with the PC's display and render it in its own PC window. Depending on the 
processing power of the PC, it can 'mix' together and render a variable number of video-windows. 

In these examples, some advanced devices have the ability to control the rendering characteristics of each 
input item independently from each other as well as the 'post-mixed' stream. For example, with a karaoke 
device, the volume of the singer's voice and the volume of the background music can be adjusted 
independently. Additionally, the volume of the post-mixed stream (i.e. singer + background) can be 
adjusted as a whole without affecting the relative settings of each individual input stream 




Figure 1: Some high-end, multiple input devices can 'mix' together multiple input streams and 
render the post mixed content on a single set of output hardware. 
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In order to support these types of devices, it is necessary for the Rendering Control Service (RCS) to 
support multiple (logical) instances of the service. As shown in Figure I, a full-featured, high-end device 
that supports multiple input streams may assigned a unique (logical) instance of the Rendering Control 
Service to each input stream. Each of these instances is assigned a unique ID (labeled RCSJD in Figure 1) 
which can be used to adjust the rendering characteristics of its associated content without affecting any of 
the other input streams. Additionally, a "default" instance (1D=0) is assigned to control the rendering 
characteristics of the 'post-mixed' stream (i.e. all input content as a whole). 

InstancelDs are used by Control Points when invoking Rendering Control Service actions. The InstancelD 
parameter (included with each action) allows the Control Point to indicate which 'stream' the invoked 
action should be applied. In order control the rendering characteristics of an individual input streams 
(independently from all of the other streams) the Control Point uses the instance ID associated with that 
stream. In order to control the rendering characteristics of the 'post-mixed' stream, the Control Point uses 
InstancelD=0. 

New (logical) instances of the Rendering Control Service (i.e. new InstancelDs) are allocated outside of the 
Rendering Control Service using some external mechanism. As of this writing, only a one allocation 
mechanism is defined. As described in Media Renderer device template, the devices's 
ConnectionManager::PrepareForConnection() action assigns a InstancelD to the input stream (i.e. each 
connection) that is being prepared. The number of instances that a device can support depends on the 
device's implementation. (Refer to the Media Renderer device templates for additional information.). 

As defined by the UPnP Architecture, a device's description document contains a single service description 
document for each (physical) service that is implemented by the device. However, when a device supports 
multiple (logical) instances of the Rendering Control Service, all of these (logical) instances are represented 
by the service description document for the one (physical) Rendering Control Service. In this case, the 
Rendering Control Service's description document reflects the actions and state variables supported by 
lnstancelD=0. All other non-zero (logical) instances must support a subset of the actions and state 
variables supported by InstanceID=0. However, each non-zero instance may support a different subset of 
InstancelDO than the other non-zero (logical) instances. For those state variables that are supported by a 
non-zero instance, each instance must support the identical "allowedValueList" and/or 
"allowedValueRange" as lnstance!D=0. If an unsupported action is invoked on a non-zero instance, the 
action will return error code 401 (Invalid Action). 

As described in the Media Renderer device template, a rendering device that contains multiple, independent 
rendering hardware (e.g. two independent display screen, or two independent sets of output speakers) shall 
be modeled as multiple instantiations of the MediaRenderer device, each with its own Rendering Control, 
Connection Manager, and (optional) AV Transport services. In other words, from an UPnP A V modeling 
point of view, each output on a physical rendering device is treated as a completely independent Media 
Rendering device. Refer to the Media Renderer device template for more information. 



2.5.2. Presets 

Named presets allow a Control Point to put the device in a predetermined state in which certain state 
variables are set to predefined values. The set of currently available presets is listed in the PresefNameList 
state variable. Since a device is permitted to add or remove support for individual presets (e.g. in 
conjunction with a vendor-defined action), the PresefNameList state variable is (indirectly ) evented as 
described in Section 2.3. Additionally, a Control Point can use the ListPresetsO action to obtain an up to 
date list of supported presets. 

A user can select one of the supported presets using the SelectPreset() action. This causes the device to set 
itself to a known state as defined associated by the selected preset. The exact definition of each preset is 
device-specific. 

For informational purposes, Section Error! Reference source not found, includes one possible definition 
for two vendor-specific actions to allow Control Points to dynamically create/destroy name presets. These 
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actions are not part of this service template, but may be useful for those developers that wish to support this 
capability. 



2.5.3. Controlling the Display of Visual Content 

The Rendering Control Service exposes a number of state variables that allow Control Points to control the 
appearance of visual content. These include such characteristics as brightness, contrast, color intensity, etc. 
In order to control these characteristics, the Control Point simply invokes the appropriate action. For most 
of these actions, the desired setting of the display characteristics is passed in by the Control Point. In most 
cases, this parameter is a positive number between 0 and some device-specific maximum value. Each 
incremental value (i.e. an increase or decrease by one) corresponds to the smallest amount of change 
supported by the device. 

Determine the current Brightness setting of the main display: 

• Invoke GetBrightness() with an Instance ID of zero. 

• A return value of 13 indicates that the display's Brightness is currently set to 13 "steps" (e.g. 13 
device-specific increments) above the dimmest setting that is supported by the device. 



Set the Brightness of the PIP display to the dimmest setting supported by the device : 

• Invoke SetBrightness() with the PIP's InstancelD and a Brightness setting of 0. 



2.5.4. Controlling Audio Content 

The Rendering Control Service exposes a set of state variables that can be used to control the audio output 
of a device. These include various characteristics such as volume, mute, and loudness. However, unlike 
most visual content, audio content is typically composed of one or more channels (e.g. a left and right 
channel). The Rendering Control service allows Control Points to control each of these channels 
independently or as a whole. In order to accomplish this, it is necessary for the Control Point to identify 
the channel that is to be controlled. This is accomplished via the 'Channel' parameter included in each 
action that is associated with the audio portion of an input stream. Each channel is uniquely named as 
described in Section 2.2. 19. The "master" channel allows a Control Point to control the "composite" (post- 
mixed) audio content as a whole. 

When controlling the volume of a particular channel, Control Points can choose between two different 
representations of the volume setting. One representation uses the Volume state variable and the other 
representation uses the VolumeDB state variable. As described in Sections 2.2.16 and 2.2.17, the Volume 
state variable represents volume as a contiguous set of "positions" numbered from 0 to some device- 
specific maximum, and the VolumeDB state variable represents volume in units of 1/256 of a decibel (dB). 
Two pair of actions (one pair for each representation) are provided to get and set the volume of a channel. 

Set the volume of the audio content (as a whole) to the quietest (non-silent) setting: 

• Invoke the SetVoIume() action with the Channel parameter set to 'Master' and the DesiredVoIume 
parameter set to 1 . 



Set the volume of the audio content (as a whole) 20 'notches/steps' higher than the current setting 

• Invoke the GetVolumeQ action with the Channel parameter set to 'Master'. As a result of the 
previous example, the CurrentVolume out parameter returns a value of 1 indicating that the audio 



© 1999-2002 Contributing Members of the UPnP™ Forum. All rights Reserved. 



RendertngControl:! Service Template Version 1 .01 



42 



content is being rendered at volume position 1 i.e. the quietest non-silence setting supported by the 
device. 

• Invoke the SetVolumeO action with the Channel parameter set to "Master" and the 
DesiredVolume parameter set to 21 (1 + 20). This corresponds to the 20' h quietest setting 
supported by the device. 

Set the volume of the Center channel 5dB higher than the "Master" channel: 

• Invoke the GetVolumeDB() action with the Channel parameter set to •Master'. In this example, 
the CurrentVolume out parameter returns a value of -2560 (increments of l/256dB), which 
indicates that the audio content is being rendered at -lOdB. In this example, -lOdB corresponds to 
volume position 21 as set in the previous example. 

Note: The correlation between the Volume and VolumeDB (i.e. 'position' settings and dB values) 
will vary from device to device. Additionally, for any given device, the relationship between 
Volume and VolumeDB may not be consistent throughout the range of valid values. 

• Invoke the SetVolumeDB( ) action with the Channel parameter set to "CF" (for the Center Front 
channel) and the DesiredVolume parameter set to -1280 (-2560+1280 increments of l/256dB), 
which corresponds to -5dB (-10+5). 

Double the volume of the entire audio content: 

(Note: Increasing the volume by 6dB doubles the volume level.) 

• Invoke the GetVoIumeDBf) action with the Channel parameter set to 'Master'. Based on the 
previous example, the CurrentVolume out parameter returned a -1280 (increments of 1/256 dB), 
which indicates that the volume level is at -5dB. 

• Invoke the SetVolumeDB() action with the Channel parameter set to "Master" (and the 
DesiredVolume parameter set to 256 (-1280+1536increments of l/256dB), which corresponds to 
IdB(-5+6). 
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3. XML Service Description 

<?xml version="l . 0" ?> 

< scpd xmlns= "urn : schemas-upnp-org : service-1-0 " > 
< specVersion > 

< minor >0</ minor > 
</ specVersion ? 
< actionLxst > 

< action > 

< name > . . c / name > 

orgumentList ? 
< argument > 

<name> ; < / name ? 

< direction > . .< / direction ? 

< relatedStateVariable ? < / relatedStateVariable > 

< / arguments '~ 
< argument ? 

< name ? ' . / : ■ : ' .->.'■■ . . . < ■ name > 

< direction > < / direction > 

< relatedStateVanable > . . ' „ . ' < / relatedS ta teVariable > 

< / argument > 
< / argumentList > 
</ action > 
< action ? 

< name > ' tl * </ name > 

< argumentList > 
< argument > 

< name • '^lLl. < / name > 

< direction > in g / direction > 

< relatedStateVariable > < / relatedS tateVariable > 

</ argument > 
orgument ? 

< direction > . < / direction ? 

g relatedStateVariable > • /.-. f. :" .- ' ::.;■:::■•:■< / relatedStateVariable > 

c / argument ? 
</ argumentList > 
</action> 
< action > 

<name> < / name ? 

< argumentList > 
< argument > 

< name ? , . - • v : ■ </ name ? 

< direction ? i . < / direction ? 

< r e 1 a ted S ta t eVa r i ab 1 e ? / • ' < / relatedStateVariable ? 

< /ar gument ? 
< argument ? 

name? . ■ .:. ■ - I ; L, j </ name > 
g direction> ■ ;. r < / direction > 

< relatedSta teVariable > __ _ < / relatedStateVariable ? 
< / argument ? 
< / argumentList ? 
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< dxrection > . : < / direction > 

< relatedStateVarxable > __. _ </ relatedStateVariable > 

</ argument > 
< argument > 

< name > ■ </ name > 

< direction > i.n < / direction > 

< relatedStateVariable > i-/ : j:<: r.ess < / relatedStateVariable > 
</ argument > 
</ argumentList > 
< /action > 
< action > 

« name > ; ■ • . • • name> 
< argumentLxst > 



< relatedStateVariable ^ - ' relatedStateVariable > 

</ argument > 
< argument > 

<direction> ;:</ direetion> 



< relatedStateVariable > * .■_ : - </ relatedStateVariable > 
< / argument > 
< / argumentList > 
</ action > 
< actxon > 

< name >. n </name> 
< argumentList > 
< argument > 

< name > ■ ■ ' </ name > 

< direction >in</ direction > 

< relatedStateVariable >.A </ relatedStateVariable > 

</ argument > 
< argument > 

< direction > < /direction > 

< relatedStateVariable > ' . ■ .- </ relatedStateVariable > 
</ argument > 
< / argumentLxst > 
</ actxon > 
< action > 

< name > . . / . </ name > 
< argumentList > 
< argument > 

< name > </name> 



< relatedStateVarxable> < / relatedSrateVarxable> 
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</ argument > 
< argument > 

• r.aroo • " ; . 7 < / name > 

< direction > . : < /direction > 

< relatedStateVar iable > : < / relatedStateVariable > 

< / argument s 
</ argumentList > 
< /action> 
<action> 

< name » ■ ' . 7 ■ - .'.--.■.-■ < /name> 
< argumentList > 
< argument > 

< name > 7 . - . . < / name > 

< direction > / direction > 

< relatedStateVariable > \ . :v. r £ . : </ relatedStateVariable > 

< / argument > 
< argument > 

< name > ■ 1 ■ ■ ■ '< / name > 

< direction a < / direction > 

< relatedStateVanable > .7 .. :. ,.■■ < / relatedStateVariable > 
< / argument > 
</ argumentList > 

< action > 

<name> 

< argumentList > 
< argument > 
< name > . . 
< direction > 



eID</ name > 
</direction> 



< relatedStateVariable > , - < / relatedStateVanable > 



< direction>. . : < / direction > 

< relatedStateVanable > ■-- . ' _ < /' relatedStateVanable > 

< / argument > 
< / argumentList > 
< /action > 
<action> 

< name > ■■ < / name > 

< argumentList > 



< direction > .;x/ direction > 

■- relatedStateVar. able -. . . ■ relatedStateVariable > 

</ argument > 



c relatedStateVariable > ' _ < / relatedStateVar 1 able > 

< / argument > 
</ argumentList > 
</ action > 
<action> 
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< direction > ._ • < /direction > 



< relatedStateVariable >. 
</ argument > 
< argument > 

<direction> 



'< / relatedStateVariable > 



</name> 



redirection s 



< relatedStateVariable > -• < / relatedStateVariable > 

< / argument s 
< / argumentList s 
</ action s 
<action> 

< name > . ■ ■ • ■ ■ ■ . : < : r.ane > 

g argumentList s 
< argument s 



</direction> 



< relatedStateVariable s. 
< / argument s 



< / direction s 



< relatedStateVariable s ,?/ 
I3E 



/relatedStateVariables 



</ relatedStateVariable s 



< / argumentList s 
</ action s 
oction s 
< naae > ; - . 

< argumentList s 
^ argument s 



< / name s 



< direction s in < / direction s 
< relatedStateVariables* ARG TYPE In. 



< / argument s 
< argument s 



ID< / relatedStateVariable s 



< direction> ; ' < / direct. 
< relatedStateVariable s 
< / argument s 



< /relatedStateVariables 



</ action 
<actions 



<directions 



< relatedStateVariables 



< / argument s 
orgument s 



< / relatedStateVariable s 
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<name>. . 



<dxrection> < / direction > 
< relatedStateVariable » r 



r, < I relatedStateVariable > 



< / argument 
< ,/ argumentList 




< direction> . ' </direction > 



/ relatedStateVariable > 



< relatedStateVariable > ; . ->\ ■ • 

</ argument > 
< / argumentLi s t > 

< action > 

■-nanr.e ■■ • </ name > 
< argumentList > 
< argument > 

<name> . : ' . • .'."</ name > 
< direction > . . < /direction > 



< relatedStateVariable > A 
</ argument > 
< argument > 

< name > es 1 1 e i R 



< / relatedStateVariable > 



</relatedStateVanable> 



< direction > ; , . </ direction > 
<relatedStateVariable> 




</ relatedStateVariable > 



< relatedStateVariable > - TYPF, r -.'t.i:-^. r < / relatedStateVariable > 

< / argument > 



<direction> 



< relatedStateVariable > 



< /relatedStateVariable > 



</ argumentList > 
</ action > 
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< argumentList > 
< argument > 
<name> ' ; - • -. 



ction > «■/ directio: 



< relatedStateVariable > .', 
</ argument > 
< argument > 

<name>. ■ ■..;;<.. ; , ■ / " . ; 



e ID< / r e 1 a tedS ta teVar i ab 1 e > 



< relatedStateVariable > 
< / argument > 
< / argumentList > 
< /action > 
<action> 



</relatedStateVariable> 



< argui 



ntList> 



<direction> 



eIatedStateVariable >, 
< / argument > 



>< / relatedStateVariable > 



<direction> 



</dir 



< relatedStateVariable > . _. 

</ argument > 
</ argumentList > 
</action> 

< name j ■. 1 . __; . _. < name ■ 

< argumentList > 
< argument > 

< name > . . < • name > 

< direction > < / direction > 



i < / r e 1 a teds ta te Var i ab 1 e > 



< relatedStateVariable > 

< / argument > 
< argument > 

< name > ■ ./ ; ■ .■ _ 

< direction > j n< / direction > 
< relatedStateVariable > 
< / argument > 
< / argumentList > 
< / action > 
< action > 

< name > , ■ _ r 7 . \ : _ ■ 

< argumentList > 
< argument > 

- name > . . . ...«■/ ru 

<direction- . -. ,■ direc 



</relatedStateVariable> 



< / relatedStateVariable> 
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< relatedStateVariable s 
< / argument s 
< argument > 
< names ■ 

< direction > ■ < / direction > 
< relatedStateVariable > 
</ argument > 
</ argumentList > 



< / relatedStateVariab!e > 



< /relatedStateVariable s 



c argumentList s 
< arguments 



</ direction > 



< relatedState Variable s, 
</ argument > 
c argument s 



LL c / relatedStateVariable > 



<relatedStateVariable> 



-.; , : </relatedStateVariable a 



</ argumentList > 
< /actions 
< action > 

<naae> : f ! . - ■ . - 



<argui 



ntLists 



< relatedStateVariable s 
< / argument s 



< /relatedStateVariables 



<directions 



< relatedStateVariables 



< / argument s 
< / argumentList s 
</ action s 
< action > 
< name s - • - 
orgumentList s 
< argument s 



</ names 
/directions 



< relatedStateVariable s. 
< / argument s 
< argument s 



< direction s < / directio 
< relatedStateVariables - :■' i 



</ relatedStateVariables 



</ relatedStateVariable s 



< /relatedStateVariable 
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</ arguments 
</ argumentList > 
</action> 
<action> 

< name > _ , < - name • 

< argumentList > 
< argument > 

< name > I:..- ; .- : ' </ name > 
<direction> in< / dxrection > 

<: relatedStateVariable s </ relatedStateVariable > 
< / argument > 
< argument > 

< name > , . : : . < / name > 

< directions < / direction s 

< relatedStateVariable s : < / relatedStateVariable > 

< / argument s 
< / argumentList s 
< /actions 



< argumentList 
< argument s 
< names 1 ns 



< relatedStateVariable s < / relatedStateVariable s 

< / argument s 
< argument s 



< relatedStateVariable s f_i_ - >~ </ relatedStateVariable s 

< / argument s 
< / argumentList s 
< /actions 
< action > 

< name s < / name s 

orgumentList s 
orgument s 

< name s < / name s 

< direction s.j ?;< / direction s 

< relatedStateVariable > -' ■ '." :. . • . ■ ; < / relatedStateVariable s 
< / argument s 
< argument s 



< relatedStateVariable s, _ < / relatedStateVariable s 

</ arguments 



< directions^ . ; < / direction s 

< relatedStateVariable s, '. < / relatedStateVariable s 
< / argument s 
< / argumentList s 
</actions 
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<action> 

< name > </name> 
< argumentList > 
< arguntent > 

< name > : - ' ■■ ' . ■ •■--.'" </ name > 
< direction > ; ;, </ direction > 

< relatedStateVariable > /: AS. A AS'A :. • : .'::/ :< / relatedStateVariable > 
</ argument > 
< argument > 

e direction > :< /direction > 

< relatedSta teVar i ab 1 e > .■ ■ ■ ■ _ , __ , ' < / relatedStateVariable > 

</ argument > 
< argument > 

< name >. : </ name > 

< direction > -.'; </ direction > 

< relatedStateVariable >: • . </ relatedStateVariable > 
</ argument > 
< / argumentList > 
</ action > 
< action > 

< name > . ... •< ,/ naroe > 
< argumentList > 
< argument > 

< name > </name> 
< direction > . : < / direction s 

< relatedStateVariable > < / relatedStateVariable > 

< / argument > 
< argument > 

< name > . .... < ,/ name > 

c direction > : < /direction > 

< relatedStateVariable > A A A ■ TAAA ':....•.:.■:/ < / relatedStateVariable > 

</ argument > 
< argument > 

< name > </name> 
< directions </ direction > 

< relatedStateVarxable > . . . </relatedStateVariable > 
< / arguroent > 
</ argumentList > 
</ action > 
< action > 
name _ < / name > 

< argumentList > 
c argument > 

< name > " . . </name> 

< directxon > ..< /direction > 

< relatedStateVariable > _ _ , _ </ re!atedStateVariable > 

< / argument > 
< argument > 

name •• / name > 
< direction j . 1 < / direction > 
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< relatedStateVarxable >. ; ; . 
< / arguments 
< argument > 



<name> i r 



</ name > 



< / relatedStateVariable > 



< direetion > i n< / direction > 

< relatedStateVariable > / . ~< / relatedStateVariable > 
</ argument > 
< / argumentList > 



c argumentList > 
< argument > 
<name> Ins t . 



< /direction > 



c relatedStateVariable >/- 
< / argument > 
< argument > 



</ name > 
</ dxrectxo. 



<relatedStateVarxable> 



'< / reIatedStateVarxable > 



< / re!atedStateVariable > 



<direction> 



</ name > 

</ direction > 



< relatedStateVariable > 
< / argument > 
< / argumentList > 
</ action > 

< name -- _-< 'name- 

< argumentList > 
< argument > 

< name > < / name 

< dxrectxon > ^ / dxrectxc 



</relatedStateVarxable> 



< relatedStateVariable > 
c / argument > 
< argument > 
< name > . . : 



c/ name > 
c/directxo 



</ relatedStateVarxable 



< relatedStateVariable 
< / argui 



argument > 

< name > </name> 
< direction > . : < / directxon > 

< relatedStateVarxable > 
• argument . 



</ argu: 



< action > 

< name > - </ name > 

< argumentList > 



</relatedStateVariable> 



< / relatedStateVarxable > 
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< relatedStateVariable ^ < / relatedStateVariable ? 

< / argument > 
< argument > 

< name > / . . ■ ■ </name> 

< direction > . .< / direction > 

< relatedStateVariable ? _ «. / relatedStateVariable > 

< /argument > 
< argument > 

< name > . </ name > 

< direction > ;■ < '' direction > 

< relatedStateVariable ? .. : :</relatedStateVariable ? 

</ argument > 
< argument ? 

<name> < . < I name ? 

< direction > : < / direction > 

< relatedStateVariable ? </relatedStateVariable > 

</ argument > 



</action> 
< action > 
< name > 

orgumentList 



< relatedStateVariable ? '. \'Y': ...■...:< / relatedStateVariable ? 

< / argument ? 



< relatedStateVariable ? '< / relatedStateVariable > 

</ argument > 
< argument > 

< name ?Current / c .■■--■ < ,/ name > 

< direction ? </ direction > 

< relatedSta teVar i abl e > L o u dn e s s < / relatedStateVariable > 
</ argument > 
< / argumentList > 
</ action > 

7 . < /name> 




; 'JJ2< / name ? 
</ direction ? 

< relatedStateVariable ?" ■ ; - ■ TY Y~ :rr~-.: < / relatedStateVariable ? 

< / argument ? 
< argument > 

<name> j</name> 
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< relatedStateVariable > /t Af:C T'Y r F , < / relatedStateVariable > 

</ argument > 
< argument > 

< name ?_ . _ < < / name > 

< direction > i .?< /direction> 

< relatedStateVariable > : . ; . < / relatedStateVariable > 

</ argument > 
</ argumentList > 
< /action > 



</ actionList > 

< services tateTable > 

< stateVariable sendEvents = "no" > 
< name > : ' </ name > 

< dataType > s t r i. ng< / dataType > 
</ stateVariable > 

< stateVariable sendEvents = " yes " 
- r.ai:ie -» .:■ </ name > 

< dataType -- < ' dataType > 

< / stateVariable > 

< stateVariable sendEvents = "no" > 

< dataType >....</ dataType > 
< allowedValueRange > 

< minimum > </ mxnimum > 

r defined< /ma: 



< / allowedValueRange > 
</ stateVariable > 
< stateVariable sendEvents=" 



< dataType > ; ■ < / dataType > 
< allowedValueRange > 

< maximum > . 1^ ^n</] 

< step > :</ step > 
< / allowedValueRange > 
</ s tateVar iable > 
< stateVariable sendEvents= "no 



< dataType >:; . /.< / dataType > 

< allowedValueRange > 
< mxnimum > </ minimuiri > 
< maximum > .--rid or de 
< s tap > 1 < / step > 

< / allowedValueRange > 

stateVar iable > 



' ~ <c maximum > 



stateVariable sendEvent 



< dataType > i: 1 2< / dataType > 
< allowedValueRange > 

< minimum > : < / minimum > 

< maximum > ' j j~ : < i . r.ed< / maxii 

< step > J</ step > 
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< / aIlowedValueRange > 
stateVariable> 



stateVariable sendEvents= "no " > 



cnauie>. .-: ■ 



< dataType > ■ 1 </ dataType > 
< allowedValueRange > 

</ minimum > 

'endor defi ned< / maximum > 

< / allowedValueRange > 
< / stateVariable > 

< stateVariable sendEvents = "no" > 

•- name • ' .■ </ name > 

< dataType > < / da tatype > 
< allowedValueRange > 
< minimum > 0< / minimum > 
< maximum > Vendor defined< / maximum > 
< step > 1< / step > 
</ allowedValueRange > 
</ stateVariable > 
< stateVariable sendEvents = 




< dataTyp e> l ; /.< / datatype > 
< allowedValueRange > 

'< / minimum > 



< maximum > '^ar r ds f i r.r-d< / maximum ? 
< step > 1< I step > 
< / allowedValueRange > 
< / stateVariable > 

< stateVarxable sendEvents = " no " > 

<name^ < name > 

< dataType > _ . J < / dataType > 
< allowedValueRange > 



def i neck / maximum > 



< step >i</ step > 

</ allowedValueRange > 
< / state Variable > 
< stateVariable sendEvents = "no" : 

< name > </nj 




< ,/ allowedValueRange > 
< / stateVariable > 
< stateVariable sendEvents = 
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<name> , _ ^ ' name > 

< da ta Type >i2</ da taType > 

< allowedValueRange > 

c minxmum ^ : .•• : , ' , > i itt be <= Q)</\ 
< maximum > Vendor de £± r.ed< / maximum > 
< step >l< / step > 

< / allowedValueRange > 
</ stateVariable 3 

< stateVariable sendEvents ="no" > 

< name > - :■ : ; .' ' ■> < / name > 

< dataType > . </ dataType > 
< allowedValueRange > 

< minimum > ' , f ir.ea (Must c c <- 0J </m 

< maximum > Vendor def med< / maximum > 
< step > J</ step > 
< / allowedValueRange > 
</ stateVariable > 
< stateVariable sendEvents = "no" > 
< name > - ; </ name > 
< dataType >. ; ■ data Type > 
• s tateVariable > 

< stateVariable sendEvents = "no" > 

< dataType >u : < / dataType > 

< a 1 1 owedVa 1 ueRange > 

def i ned< / maximum > 

< / allowedValueRange > 
< / stateVariable > 

< stateVariable sendEvents - "no" > 
< name > < / name > 

< da taType > i ,?< / da taType > 
< allowedValueRange > 

< maximum > , i . ,</ maximum > 
< step > -:d ■ -.1 ' ■ < /£te£> 
< / al lowedValueRange > 
</ stateVariable > 

< stateVariable sendEvents ="no" > 

< name > . ■ . < / name > 

< da taType > < / dataType > 

< / state Variable > 

< stateVariable sendEvents = " no " > 

< name > i ■■/ < / name > 

< dataType >. _ ,■< / da taType > 

< allowedValueList > 

< allowedValue >' . ' < / allowedValue 
< allowedValue > ; - < / allowedValue > 

< a 1 1 o wedVa 1 u e > . - / < / a 1 1 ow edVa 1 u e > 
< allowedValue >Si < / allowedValue > 
< allowedValue > Lt , £ </ allowedValue > 
< allowedValue > I 5 </ allowedValue > 

< a 1 1 o wedVa lue >RS< / all o wedVa 1 ue > 

< a 1 lowedVa 1 ue > I FC< / all owedVa 1 ue > 

< a 1 1 o wedVa 1 ue > F. F\ < / all o wedVa 1 ue > 

< a 1 1 owedVa 1 u e > S 1 < / a 1 1 o wed Va 1 u e > 
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oil owedVa lue > S L< / allowedValue > 
< a 1 1 o wedVa 1 u e > .-; - < / allowedValue > 
< allowedValue > T< / allowedValue > 
< allowedValue >.^< / allowedValue > 
< allowedValue >Ve n i ■ : 1 = f ; r, e :1< I allowedValu 
</ allowedValueList > 
< / stateVanable > 
< s tateVariable sendEvents = "no" > 

< name ^ ' A'— :.■ .v-: < 'name . 

< dataType > < / dataType > 
< / stateVariable > 

< s tateVariable sendEvents ="no" > 

< name > _ < / name > 

< da ta Type > s c r i n g< / da taType > 



< allowedValueList > 

< allowedValue >.- --.-- : /' e; r : - . </ allowedValue > 
< allowedValue > ' . ..'•. •< / allowedValue > 

< allowedValue > .'<r ne: . ::;■■•;< / allowedValue > 

</ allowedValueList > 

s tateVariable > 



</ services tateTable > 
< / scpd > 
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4. Test 

There are no semantic tests mandated for this service. 



© 1999-2002 Contributing Members of the UPnP™ Forum. All rights Reserved. 



RenderingControhl Service Template Version 1.01 



59 



5. "LastChange" State Variable Schema 

The following XML schema describes the format of the LastChange state variable, which is used for 
eventing state changes that occur with this service. Refer to Section 2.2. 1 (LastChange) and Section 2.3 
(Eventing and Moderation) for additional details. 



<?xml version=" 1 . 0" encoding= "UTF- 8 " ? > 

<xsd : schema targetNamespace= "urn : schema s -upnp-org : metadata- 1 - 0/RCS/ " 
xmlns : res = "urn : schema s -upnp - org : metadata - 1 - 0/RCS / " 
xmlns :xsd="http : //www . w3 . org/20 01/XMLSchema" 

elementPormDef ault=" qualified" attributeFormDef ault= "unqualified" > 

<xsd : annotations 

<xsd: documentation xml : lang= "en" >Schema for UPnP A/V Rendering 
Control Service events, version 0 . 1< /xsd : documentations 

</xsd: annotations 

<xsd : import namespace="http : / /www. w3 . org /XML /I 998/name space" 
schemaLocation= "http : / /www .w3.org/2001/xml. xsd "/> 



'Event' is the root element of Rendering Control event document 
'InstancelD' is the only valid child of 'Event'. 



exsd: element name=" Event" type= " res : rootType " / > 
<xsd: complexType name= "rootType " > 

<xsd : documentationsEvent is the root 
element< /xsd: documentations 
< /xsd : annotations 

<xsd:choice minOccurs= " 0 " maxOccurs= "unbounded" s 
<xsd: element ref ="rcs : Instance ID" /> 

</xsd: complexTypes 



'InstancelD' elements identify an individual event instance. 



<xsd : group name=" allowed -under -Instance ID" s 
<xsd : annotations 

<xsd : documentationsThis group define 
under the InstancelD element< /xsd : documentations 
< /xsd : annotations 
<xsd: choices 



<xsd 


element 


ref = 


' res 


PresetNameList " / > 


<xsd 


element 


ref = 


'res 


Brightness"/s 


<xsd 


element 


ref = 


'res 


Contrast "/s 


<xsd 




ref = 


'res 


Sharpness " / > 


<xsd 


element 


ref = 


'res 


RedVideoGain" /> 


<xsd 


element 


ref = 


'res 


GreenVideoGain" / s 


<xsd 


element 


ref = 


'res 


BlueVideoGain"/s 


<xsd 




ref = 




RedVideoBlackLevel " / s 


<xsd 


element 


ref = 




GreenVideoBlackLevel " / s 


<xsd 




ref = 




Bl ueVi deoBlackLevel " / s 
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<xsd 


element 


ref = 


'res 


ColorTemperature " / > 


<xsd 


element 


ref = 


'res 


Hori zontalKeystone " / > 


<xsd 


element 


ref = 


res 


VerticalKeystone"/> 


<xsd 


element 


ref = 


res 


Mute"/> 


<xsd 


element 


ref = 


res 


Volume "/> 


cxsd 


element 


ref = 


res 


VolumeDB" / > 


<xsd 




ref = 




Loudness " / > 



</xsd:choice> 
</xsd:group> 

<xsd:element name= " InstancelD " type= " res : Ins tancelDtype " / > 
<xsd: complexType name= " InstancelDtype " > 
<xsd : annotation> 

<xsd:documentation>InstanceID elements identify an 
individual event instance .< /xsd : documentations 
</xsd : annotation> 

<xsd:choice minOccurs= " 0 " maxOccurs= "unbounded " > 

<xsd: group ref =" res : al 1 owed -under- InstancelD" /> 
</xsd : choices 
</xsd: complexType> 



PresetNameList 



<xsd : element name= "PresetNameList " > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : string 11 
use=" required" /> 

</xsd : complexType > 
</xsd:element> 



<xsd : element name= "Brightness " > 
<xsd : complexType > 

<xsd : attribute name="val" type= 
use="required"/> 

</xsd : complexType> 
</xsd:element> 



Contrast 



<xsd: element name= "Contrast " > 
<xsd: complexType > 

<xsd : attribute name="val" type= "xsd : unsignedlnt " 
use= " required"/ > 

</xsd: complexType> 
</xsd:element> 



Sharpness 
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<xsd: element name= "Sharpness " > 
<xsd : complexType> 

<xsd : attribute name="val" type="xsd:i 
use= "required"/> 

</xsd: complexType> 
</xsd:element> 



RedVideoGai 



<xsd : element name= "RedVideoGain" > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : unsignedlnt " 
use= "required" /> 

</xsd: complexType> 
</xsd:element> 



GreenVideoGain 



< xsd : element name= "GreenVideoGain" > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : unsignedlnt " 
use= " required" /> 

</xsd : complexType> 
</xsd: element> 



BlueVideoGain 



<xsd : element name= "BlueVideoGain" > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : unsignedlnt " 
use= " required" /> 

< /xsd : complexType> 
< /xsd: element > 



RedVideoBlackLevel 



<xsd : element name= "RedVideoBlackLevel " > 
<xsd : complexType> 

<xsd : attribute name="val" type= "xsd : unsignedlnt " 
use="required"/ > 

</xsd : complexType> 
</xsd : elements 



GreenVideoBlackLevel 
<xsd : element name= "GreenVideoBlackLevel " > 
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<xsd: complexType> 

<xsd:attribute name="val" type = "xsd : unsignedlnt " 
"required"/ 5 

</xsd: complexType> 
< /xsd : element > 



BlueVideoBlackLevel 



<xsd: element name="BlueVideoBlackLevel " > 
<xsd : complexType> 

<xsd : attribute name="val" type = "xsd : unsignedlnt " 
use= " required" / > 

</xsd: complexType> 
</xsd : element> 



ColorTemperature 



<xsd : element name= " ColorTemperature 11 > 
<xsd : complexType> 

<xsd : attribute name="val" type= "xsd : unsignedlnt " 
use= " required" /> 

</xsd : complexType> 
< /xsd: element > 



Horizontal Key st one 



<xsd : element name= "Horizontal Key stone " > 
<xsd : complexType> 

<xsd : attribute name="val" type= "xsd : integer " 
use= "required" /> 

< /xsd : complexType> 
</xsd:element> 

Vert icalKeys tone 



<xsd : element name= "VerticalKeystone " > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : integer " 
use= "required" / > 

</xsd: complexType> 
</xsd: element> 



<xsd: element name="Mute"> 
<xsd : complexType> 
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<xsd : attribute name="val" type= "xsd : boo! e 
use="required"/> 

<xsd : attribute name =" channel " type="xsd:s 
use= " required" / > 

c/xsd : complexType> 
</xsd : element> 



<xsd : element name= "Volume " > 
<xsd : complexType> 

<xsd:attribute name="val" type= "xsd : unsignedlnt " 
use= " required "/> 

cxsd : attribute name= " channel " type= "xsd : string" 
use= "required" /> 

</xsd : complexType> 
</xsd:element> 



<xsd: element name= "VolumeDB " > 
■cxsd : complexType> 

<xsd : attribute name="val" type= "xsd : integer " 
use= " required " / > 

<xsd : attribute name= " channel " type= "xsd : strin 
use= "required" / > 

< /xsd : complexType> 
</xsd:element> 



<xsd:element name = "Loudness " > 
<xsd : complexType> 

<xsd: attribute name="val" type= "xsd : boolean " 

<xsd: attribute name= " channel " type= "xsd : string" 
use= "required"/ > 

< /xsd : complexType> 
</xsd: element> 



< /xsd : schema> 
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